home *** CD-ROM | disk | FTP | other *** search
/ Inter.Net 55-1 / Inter.Net 55-1.iso / CBuilder / Setup / BCB / data.z / tdstrp32.txt < prev    next >
Encoding:
Text File  |  1998-02-09  |  5.3 KB  |  138 lines
  1. TDSTRP32 Help
  2.  
  3. 1. TDSTRP32: The symbol table stripping utility
  4. ==============================================
  5. TDSTRP32.EXE lets you remove the symbol table from an executable program.
  6. This is a faster way of removing the symbol table than recompiling and
  7. relinking your program without symbolic debug information. TDSTRP32 can
  8. also remove debugging information from an .OBJ file:
  9.  
  10.    TDSTRP32 PROGRAM.OBJ
  11.  
  12. You can also use TDSTRP32 to remove the symbol table and put it in
  13. a separate file. This is useful when you want to convert the .EXE
  14. format program to a .COM file and still retain the debugging symbol
  15. table. TDSTRP32 puts the symbol table in a file with the extension
  16. .TDS. Turbo Debugger looks for this file when it loads a program to
  17. debug that doesn't have a symbol table.
  18.  
  19.  
  20. TDSTRP32 command-line options
  21. ----------------------------
  22. The general form of the DOS command line used to start TDSTRP32 is:
  23.  
  24.    TDSTRP32 [-s] [-c] <exename> [<outputname>]
  25.  
  26. If you don't specify the -s option, the symbol table is removed from
  27. the .EXE file <exename>. If you specify an <outputname>, the original
  28. .EXE file is left unchanged and a version with no symbol table is created
  29. as <outputname>.
  30.  
  31. If you do specify the -s option, the symbol table will be put in a
  32. file with the same name as <exename> but with the extension .TDS. If you
  33. specify an output file, the symbol table will be put in <outputname>.
  34.  
  35. If you specify the -c option, the input .EXE file is converted into a
  36. .COM file. If you use -c in conjunction with -s, you can convert an
  37. .EXE file with symbols into a .COM file with a separate .TDS symbol
  38. file. This lets you debug .COM files with Turbo Debugger while
  39. retaining full debugging information.
  40.  
  41. You can only convert certain .EXE files into .COM files. The same
  42. restrictions apply to the -c option of TDSTRP32 as to the /t option of
  43. TLINK: Your program must start at location 100 hex, and it can't
  44. contain any segment fixups.
  45.  
  46. The default extension for <exename> is .EXE. If you add an extension,
  47. it overrides the default.
  48.  
  49. There are two default extensions for <outputname>,
  50.  
  51. o .TDS when you use the -s command-line switch
  52. o .EXE when you don't use the -s command-line switch
  53.  
  54. If you add an extension, it overrides the defaults.
  55.  
  56. Here are some sample TDSTRP32 command lines. The following command
  57. removes the symbol table from MYPROG.EXE:
  58.  
  59.    TDSTRP32 MYPROG
  60.  
  61. The following command removes the symbol table from MYPROG.OLD
  62. and places it in MYPROG.TDS:
  63.  
  64.    TDSTRP32 -s MYPROG.OLD
  65.  
  66. The following command leaves MYPROG.EXE unchanged but creates another
  67. copy of it named MYPROG.NEW without a symbol table:
  68.  
  69.    TDSTRP32 MYPROG MYPROG.NEW
  70.  
  71. The following command removes the symbol table from MYPROG.EXE and
  72. places it in MYSYMS.TDS:
  73.  
  74.    TDSTRP32 -s MYPROG MYSYMS
  75.  
  76.  
  77. TDSTRP32 error messages
  78. ----------------------
  79. Following is a list of TDSTRP32 error messages:
  80.  
  81. Can't create file: ___
  82.   TDSTRP32 couldn't create the output symbol or .EXE file. Either there
  83.   is no more room on your disk, or you specified an invalid output file
  84.   name.
  85.  
  86. Can't open file: ___
  87.   TDSTRP32 could not locate the .EXE file from which you want to remove the
  88.   symbol table.
  89.  
  90. Error reading from input exe file
  91.   An error occurred during reading from the input executable program
  92.   file. Your disk may be unreadable. Try the operation again.
  93.  
  94. Error writing to output file: ___; disk may be full
  95.   TDSTRP32 couldn't write to the output symbol or executable file. This
  96.   usually happens when there is no more room on your disk. You will have
  97.   to delete some files to make room for the file created by TDSTRP32.
  98.  
  99. Input file is not an .exe file
  100.   You've specified an input file name that isn't a valid executable
  101.   program. You can strip symbols only from .EXE programs because these
  102.   are the only ones that TLINK can put a symbol table in. Programs in
  103.   .COM file format don't have symbol tables and can't be processed by
  104.   TDSTRP32.
  105.  
  106. Invalid command-line option: ___
  107.   You've given an invalid command-line option when starting TDSTRP32
  108.   from the DOS command line.
  109.  
  110. Invalid exe file format
  111.   The input file appears to be an .EXE format program file, but
  112.   something is wrong with it. You should relink the program with TLINK.
  113.  
  114. Not enough memory
  115.   Your system doesn't have enough free memory for TDSTRP32 to load and
  116.   process the .EXE file. This only happens in extreme circumstances
  117.   (TDSTRP32 has very modest memory requirements). Try rebooting your 
  118.   system and running TDSTRP32 again. You might have previously run a
  119.   program that allocated some memory that won't be freed until you reboot.
  120.  
  121. Program does not have a symbol table
  122.   You've specified an input file that's a valid .EXE file, but it
  123.   doesn't have a symbol table.
  124.  
  125. Program does not have a valid symbol table
  126.   The symbol table at the end of the .EXE file isn't a valid TLINK
  127.   symbol table. This can happen if you try to use TDSTRP32 on a program
  128.   created by a linker other than TLINK. Relink the program with TLINK.
  129.  
  130. Too many arguments
  131.   You can supply a maximum of two arguments to TDSTRP32, the first being
  132.   the name of the executable program, and the second being the name of
  133.   the output file for symbols or the executable program.
  134.  
  135. You must supply an exe file name
  136.   You've started TDSTRP32 without giving it the name of an .EXE program
  137.   file whose symbol table you want to strip.
  138.